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ABOUT THIS CHAPTER 


The Font Manager is the part of the Toolbox that supports the use of various 
character fonts when you draw text with QuickDraw. This chapter introduces you 
to the Font Manager and describes the routines your application can call to get 
font information. It also describes the data structures of fonts and discusses 
how the Font Manager communicates with QuickDraw. 


You should already be familiar with: 
« the Resource Manager 


¢ the basic concepts and structures behind QuickDraw, particularly 
bit images and how to draw text 
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ABOUT THE FONT MANAGER 


Note: The extensions to the Font Manager described in this chapter were 
Originally documented in Inside Macintosh, Volumes IV and V. As such, 
the Volume IV information refers to the 128K ROM and System file 
version 3.2 and later, while the Volume V information refers to the 
Macintosh SE and Macintosh II ROMs and System file version 4.1 and 
later. The sections of this chapter that cover these extensions are 
so noted. 


The main function of the Font Manager is to provide font support for QuickDraw. 
To the Macintosh user, font means the complete set of characters of one 
typeface; it doesn't include the size of the characters, and usually doesn't 
include any stylistic variations (such as bold and italic). 


Note: Usually fonts are defined in the plain style and stylistic 
variations are applied to them; for example, the italic style 
simply slants the plain characters. However, fonts may be designed 
to include stylistic variations in the first place. 


The way you identify a font to QuickDraw or the Font Manager is with a font 
number. Every font also has a name (such as "New York") that's appropriate to 
include in a menu of available fonts. 


e*eClick on the X-Ref button, and refer to Technical Note #191, eee 


The size of the characters, called the font size, is given in points. Here this 
term doesn't have the same meaning as the "point" that's an intersection of 
lines on the QuickDraw coordinate plane, but instead is a typographical term 
that stands for approximately 1/72 inch. The font size measures the distance 
between the ascent line of one line of text and the ascent line of the next line 
of single-spaced text (see Figure 1). 


Note: Because measurements cannot be exact on a bit-mapped output device, 
the actual font size may be slightly different from what it would be 
in normal typography. Also be aware that two fonts with the same 
font size may not actually appear to be the same size; the font size 
is more useful for distinguishing different sizes of the same font 
(this is true even in typography). 
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Ascent line 


Figure 1-Font Size 
Figure 1-Font Size 


Whenever you call a QuickDraw routine that does anything with text, QuickDraw 
passes the following information to the Font Manager: 


e The font number. 
e The character style, which is a set of stylistic variations. The 
empty set indicates plain text. (See the QuickDraw chapter for details.) 
« The font size. The size may range from 1 point to 127 points, but for 
readability should be at least 6 points. 
¢ The horizontal and vertical scaling factors, each of which is 
represented by a numerator and a denominator (for example, a numerator 
of 2 and a denominator of 1 indicates 2-to-1 scaling in that direction). 
¢ A Boolean value indicating whether the characters will actually be drawn 
or not. They will not be drawn, for example, when the QuickDraw function 
CharWidth is called (since it only measures characters) or when text is 
drawn after the pen has been hidden (such as by the HidePen procedure 
or the OpenPicture function, which calls HidePen). 
« Device specific information that enables the Font Manager to achieve 
the best possible results when drawing text on a particular device. 
For details, see the section "Communication between QuickDraw and the 
Font Manager" below. 


Given this information, the Font Manager provides QuickDraw with information 
describing the font and—if the characters will actually be drawn—the bits 
comprising the characters. 


Fonts are stored as resources in resource files; the Font Manager calls the 
Resource Manager to read them into memory. System-defined fonts are stored in 
the system resource file. You may define your own fonts and include them in the 
system resource file so they can be shared among applications. In special cases, 
you may want to store a font in an application's resource file. It's also 
possible to store only the character widths and general font information, and 
not the bits comprising the characters, for those cases where the characters 
won't actually be drawn. 
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A font may be stored in any number of sizes in a resource file. If a size is 
needed that's not available as a resource, the Font Manager scales an available 
size. 


Fonts occupy a large amount of storage: A 12-point font typically occupies 
about 3K bytes, and a 24-point font, about 10K bytes; fonts for use on a high 
resolution output device can take up four times as much space as that (up to 32K 
bytes). Fonts are normally purgeable, which means they may be removed from the 
heap when space is required by the Memory Manager. If you wish, you can call a 
Font Manager routine to make a font temporarily unpurgeable. 


There are also routines that provide information about a font. You can find out 
the name of a font having a particular font number, or the font number for a 
font having a particular name. You can also learn whether a font is available in 
a certain size or will have to be scaled to that size. 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


The Font Manager has been significantly improved by the addition of new data 
structures, most notably the family record. Containing additional typographic 
information about a font, the family record allows more fonts, fractional 
character widths (that is, character widths expressed as fixed-point numbers 
rather than simple integers) for greater precision on high-resolution devices 
such as the LaserWriter, and the option of disabling font scaling for improved 
speed and legibility. 


The addition of the family record and its related data structures is transparent 
to most existing applications and is of interest only to advanced programmers 
designing specialized fonts for the LaserWriter or writing their own font 
editors. 


Most programmers will simply want to take advantage of the new features. Two 
routines, SetFractEnable and SetFScaleDisable, are provided for this purpose; 
they're described in "Font Manager Routines" below. 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


The Font Manager has been enhanced in the Macintosh SE and Macintosh II. 
Multibit pixel description for fonts provides color support on the Macintosh II; 
this includes the ability to create "gray-scale" fonts—character images with 
shades of gray (instead of merely black and white). 


The SetFractEnable routine has been put into ROM, various bugs have been fixed, 
and a better font search algorithm has been implemented. 


@ SpInside Macintosh ¢ Version 1.0 * November 1989 « Apple Computer 
THE FONT MANAGER ¢« 6 of 54 


FONT NUMBERS 


Note: The information on Font Numbers described in the following 
paragraphs was originally documented in Inside Macintosh, Volume I. 


The Font Manager includes the following font numbers for identifying system- 
defined fonts: 


CONST systemFont = 0; {system font} 
applFont = 1; {application font} 
newYork =2* 
geneva = 3; 
monaco = 4; 
venice = 5; 

London = 6; 
athens =7% 
sanFran = 8; 
toronto = 9; 
cairo = 11; 
losAngeles = 12; 
times = 20; 
helvetica = 21; 
courier = 22; 
symbol = 23; 
taliesin = 24; 


The system font is so called because it's the font used by the system (for 
drawing menu titles and commands in menus, for example). The name of the system 
font is Chicago. The size of text drawn by the system in this font is fixed at 
12 points (called the system font size). 


The application font is the font your application will use unless you specify 
otherwise. Unlike the system font, the application font isn't a separate font, 
but is essentially a reference to another font-—Geneva, by default. (The 
application font number is determined by a value that you can set in parameter 
RAM; see the Operating System Utilities chapter for more information. ) 


Assembly-language note: You can get the application font number 
from the global variable ApFontID. 


FONTS AND THEIR FAMILIES 


Note: The extensions to the Font Manager described in the following section 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


In the 64K ROM version of the Font Manager, font is defined as the complete set 
of characters of one typeface; it doesn't include the size of the characters, 
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and usually doesn't include any stylistic variations. In other words, fonts are 
defined in the plain style and stylistic variations, such as bold and italic, 
are applied to them. For example, Times plain (or roman) defines the font, while 
Times italic is a stylistic variation applied to that font. 


In the 128K ROM version, the definition of a font is broadened to include 
stylistic variations. That is, a separate font can be defined for certain 
stylistic variations of a typeface. The set of available fonts for a given 
typeface is known as a font family. 


This allows QuickDraw to use an actual font instead of modifying a plain font, 
thereby improving speed and readability. For example, suppose the user of a word 
processor selects a phrase in 12-point Times Roman and chooses the italic style 
from a menu. QuickDraw asks for an italic Times and, assuming that the proper 
resources are available, the Font Manager returns a 12-point Times Italic font. 
QuickDraw could then draw the phrase from an actual italic font rather than 
having to slant the plain font. 


Note: The standard stylistic variations will still be performed by 
QuickDraw when they're not available as actual fonts. 


Information about fonts and their families is stored as resources in resource 
files; the Font Manager calls the Resource Manager to read them into memory. 
Fonts are stored as resources of type 'FONT' or 'NFNT'. Fonts known to the 
system are stored in the system resource file; you may also define your own 
fonts and include them in your application's resource file. The information 
about a font family is stored as a resource of type 'FOND'; this includes the 
resource IDs of all the fonts in the family, as shown in Figure 2. 


FoHD 
resource 
resource ID 


resource ID 


Figure 2—Font Manager Resouces 


Figure 2—Font Manager Resources 
eeeClick on the X-Ref button, and refer to Technical Note #198.¢ee 


The 'NFNT' resource is new to the 128K ROM version of the Font Manager; it has 
the same format as the 'FONT' resource and allows for many more fonts. An 'NFNT' 
resource type can also be used to mask all but plain fonts from appearing in a 
font menu. In this way, the system resource file can contain Times, Times 
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Italic, Times Bold, and Times Bold Italic, yet only Times will appear on the 
Font Menu. (The user would need to choose Italic from the Style menu. ) 


The 64K ROM can only handle 'FONT' resources; it ignores resources of type 
'NFNT' and 'FOND'. 


Warning: If you're creating a font, be sure to read the section 
"Restrictions on the 'FONT' type" below for information 
on maintaining compatibility with the 64K ROMs. 


It's crucial that all new fonts have a corresponding 'FOND' resource. A minimal 
'FOND' resource can be made for a font by using the Font/DA Mover (version 3.0 
or later) to copy the font into a different file that has no font with the same 
name. 


Note: A 'FOND' resource created this way does not contain any optional 
tables, but it does contain the font association table (described 
below) that maps family numbers and font sizes into resource IDs. 


Warning: Be aware that when a 'FOND' is present, the Font Manager uses 
it exclusively to determine which fonts are available. Fonts 
should be added to or deleted from the System file with a tool 
like the Font/DA Mover, which correctly updates the 'FOND' as 
well as the 'FONT'. 


The Font Manager uses these resources to build two data structures in the 
application heap. The font record contains information about a font and the 
family record contains information about a font family. 


About Names and Numbers 


In the 64K ROM version of the Font Manager, a font is identified by its font 
number, which is always between 0 and 255. Each font also has a name that's used 
to identify it in menus. Font families are identified by a family number and a 
family name. Since existing routines rely on passing and returning the font 
number in Font Manager routines, the family number must be the same as the font 
number, and the family name must be the same as the font name. Family numbers 0 
through 127 are reserved for use by Apple; numbers 128 through 255 are assigned 
by Apple for fonts created by software developers. 


eeeClick on the X-Ref button, and refer to Technical Notes #191 & 245. eee 


Assembly-language note: You can determine the system family number and size 
by reading the global variables SysFontFam and 
SysFontSiz, respectively. This is highly recommended, 
especially if your application is intended to run on 
Macintoshes that are localized for non-English- 
speaking countries, as the localization process may 
change the system font. 


You can get the family number of the application font 
from the global variable ApFontID. You can substitute 
a different family number in this variable but the 
application font is reset to its default value (it's 
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stored in parameter RAM) whenever a new application 
is launched. 


Since font numbers only range from 0 to 255, only font families with family 
numbers in this range are recognized by the 64K ROM version of the Font Manager. 
ALL fonts with family numbers from 0 through 255 are stored as resources of type 
'FONT', so that the 64K ROM's version of the Font Manager can recognize them. 


It's very important that all new fonts and font families be registered with 
Apple to avoid conflict. To register the name of a font family, write to: 


Font Registration Program 

Apple Computer, Inc. 

20400 Stevens Creek Blvd., M/S 75-3T 
Cupertino, CA 95014 


When there's a conflict, font families may be renumbered by the Font/DA Mover. 
For instance, when the Font/DA Mover moves a font or font family into a file in 
which there's already a font (or font family) with that number (but with a 
different name), the new font (or font family) is renumbered. For this reason, 
you should always call GetFNum to verify the number of a font you want to 
access. 
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FONT MANAGER DATA STRUCTURES 


Note: The extensions to the Font Manager described in this section were 
Originally documented in Inside Macintosh, Volumes IV and V. As such, 
the Volume IV information refers to the 128K ROM and System file 
version 3.2 and later, while the Volume V information refers to the 
Macintosh SE and Macintosh II ROMs and System file version 4.1 and 
later. 


This section describes the data structures that define fonts and font families, 
including fonts with depth on the Macintosh II; you need to read it only if 
you're going to define your own fonts or write your own font editor. Most of the 
information in this section is useful only to assembly-language programmers. 


Figure 3 shows some of the relationships between the various data structures 
used by the Font Manager. Handles are shown as dotted lines. 
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Figure 3-—Font Manager Data Structures 
Figure 3—Font Manager Data Structures 


Font records and family records, the structures from which global width tables 
are derived, are kept in the application heap. Global width tables, which are 
used constantly, are kept in the system heap. 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


Just as the Color QuickDraw pixel image lets you use multiple bits to describe 
each pixel, the Font Manager lets you create fonts whose character images 
contain multiple bits per pixel. The number of bits per pixel, or the font 
depth, is specified in the font record (outlined below); font depths of one, 
two, four, and eight bits are supported. 
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Drawing to the screen is considerably faster if the font depth matches the 
screen depth specified by the user in the Control Panel. For speedy access, 
4-bit and 8-bit versions of the system font, as well as a 4-bit Geneva font, are 
stored in the Macintosh II ROM as 'NFNT' resources. 


It's not necessary, however, to create separate resources matching each of the 
possible screen depths for every font family. If a resource (either of type 
'FONT' or 'NFNT') with a depth corresponding to the current screen depth can't 
be found, the Font Manager expands the 1-bit font into a synthetic font matching 
the current screen depth. 


A synthetic font list contains information about each synthetic font; the format 
of an entry in this list is given in Figure 4. The global variable 
SynListHandle contains a handle to the synthetic font list. 


Hamile to font record (long word] 
Resource ID of font [word] 


Foreground eolor (8 bytes] 
Background color (8 bytes] 


Figure 4-Synthetic Font List Entry 
Figure 4-Synthetic Font List Entry 


Format of a Font 


Note: The information on the Format of a Font described in the following 
paragraphs was originally documented in Inside Macintosh, Volume I. 


Each character in a font is defined by bits arranged in rows and columns. This 
bit arrangement is called a character image; it's the image inside each of the 
character rectangles shown in Figure 5. 


The base line is a horizontal line coincident with the bottom of each character, 
excluding descenders. 


The character origin is a point on the base line used as a reference location 
for drawing the character. Conceptually the base line is the line that the pen 
is on when it starts drawing a character, and the characer origin is the point 
where the pen starts drawing. 


The character rectangle is a rectangle enclosing the character image; its sides 
are defined by the image width and the font height: 


¢ The image width is simply the width of the character image, which 
varies among characters in the font. It may or may not include space 
on either side of the character; to minimize the amount of memory 
required to store the font, it should not include space. 

« The font height is the distance from the ascent line to the descent 
line (which is the same for all characters in the font). 
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The image width is different from the character width, which is the distance to 
move the pen from this character's origin to the next character's origin while 
drawing. The character width may be 0, in which case the following character 
will be superimposed on this character (useful for accents, underscores, and so 
on). Characters whose image width is © (Such as a space) can have a nonzero 
character width. 


Characters in a proportional font all have character widths proportional to 
their image width, whereas characters in a fixed-width font all have the same 
character width. 


Characters can kern; that is, they can overlap adjacent characters. The first 
character in Figure 5 below doesn't kern, but the second one kerns left. 


In addition to the terms used to describe individual characters, there are terms 
describing features of the font as a whole (see Figure 6). 


The font rectangle is related to the character rectangle. Imagine that all the 
character images in the font are superimposed with their origins coinciding. The 
smallest rectangle enclosing all the superimposed images is the font rectangle. 


The ascent is the distance from the base line to the top of the font rectangle, 
and the descent is the distance from the base line to the bottom of the font 
rectangle. 


The height of the font rectangle is the font height, which is the same as the 
height of each character rectangle. The maximum height is 127 pixels. The 
maximum width of the font rectangle is 254 pixels. 


The leading is the amount of blank space to draw between lines of single spaced 
text—the distance between the descent line of one line of text and the ascent 
line of the next line of text. 


Finally, for each character in a font there's a character offset. As illustrated 
in Figure 7, the character offset is simply the difference in position of the 
character rectangle for a given character and the font rectangle. 


Every font has a bit image that contains a complete sequence of all its 
character images (see Figure 8). The number of rows in the bit image is 
equivalent to the font height. The character images in the font are stored in 
the bit image as though the characters were laid out horizontally (in ASCII 
order, by convention) along a common base line. 


The bit image doesn't have to contain a character image for every character in 
the font. Instead, any characters marked as being missing from the font are 
omitted from the bit image. When QuickDraw tries to draw such characters, a 
missing symbol is drawn instead. The missing symbol is stored in the bit image 
after all the other character images. 
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Figure 5—Character Images 
Figure 5—-Character Images 
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Figure 6—Features of Fonts 


Figure 6—Features of Fonts 
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Figure 7-Character Offset 
Figure 7—Character Offset 
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Figure §—Partial Bit Image for a Font 
Figure 8—Partial Bit Image for a Font 


Warning: Every font must have a missing symbol. The characters with 
ASCII codes @ (NUL), $09 (horizontal tab), and $0D (Return) 
must not be missing from the font if there's any chance it 
will ever be used by TextEdit; usually they'll be zero-length, 
but you may want to store a space for the tab character. 


Font Records 


The information describing a font is contained in a data structure called a font 
record, which contains the following: 


the font type (fixed-width or proportional) 

the ASCII code of the first character and the last character in the font 
the maximum character width and maximum amount any character kerns 

the font height, ascent, descent, and leading 

the bit image of the font 

a location table, which is an array of words specifying the location 

of each character image within the bit image 

e an offset/width table, which is an array of words specifying the 
character offset and character width for each character in the font 


eoeeeee 


For every character, the location table contains a word that specifies the bit 
offset to the location of that character's image in the bit image. The entry for 
a character missing from the font contains the same value as the entry for the 
next character. The last word of the table contains the offset to one bit beyond 
the end of the bit image (that is, beyond the character image for the missing 
symbol). The image width of each character is determined from the location table 
by subtracting the bit offset to that character from the bit offset to the next 
character in the table. 


There's also one word in the offset/width table for every character: The high- 
order byte specifies the character offset and the low order byte specifies the 
character width. Missing characters are flagged in this table by a word value of 
-—1. The last word is also -1, indicating the end of the table. 


Note: The 64K ROM version of the Resource Manager limits the total space 
occupied by the bit image, location table, offset/width table, and 
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character-width and image-height tables to 32K bytes. For this reason, 
the practical limit on the font size of a full font is about 40 points. 


Figure 9 illustrates a sample location table and offset/width table 
corresponding to the bit image in Figure 8 above. 


A font record is referred to by a handle that you can get by calling the 
FMSwapFont function or the Resource Manager function GetResource. The data type 
for a font record is as follows: 


TYPE FontRec = RECORD 


fontType: INTEGER; {font type} 
firstChar: INTEGER; {ASCII code of first character} 
LastChar: INTEGER; {ASCII code of last character} 
widMax: INTEGER; {maximum character width} 
kernMax: INTEGER; {negative of maximum character kern} 
nDescent: INTEGER; {negative of descent} 
fRectWidth: INTEGER; {width of font rectangle} 
fRectHeight: INTEGER; {height of font rectangle} 
owTLoc: INTEGER; {offset to offset/width table} 
ascent: INTEGER; {ascent} 
descent: INTEGER; {descent} 
leading: INTEGER; {leading} 
rowwords: INTEGER; {row width of bit image / 2} 
{ bitImage: ARRAY[1..rowWords,1..fRectHeight] OF INTEGER; } 
{bit image} 
{ locTable: ARRAY[firstChar..lastChar+2] OF INTEGER; } 
{location table} 
{ owlable: ARRAY [firstChar..lastChar+2] OF INTEGER; } 


{offset/width table} 
END; 


Note: The variable-length arrays appear as comments because they're 
not valid Pascal syntax; they're used only as conceptual aids. 
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Figure 9-Sample Location Table and Offsew Width Table 
Figure 9-Sample Location Table and Offset/Width Table 


The fontType field must contain one of the following predefined constants: 


CONST propFont $9000; {proportional font} 

fixedFont $BO000; {fixed-width font}The values in the widMax, 
kernMax, nDescent, fRectWidth, fRectHeight, ascent, descent, and leading fields 
all specify a number of pixels. 


KernMax indicates the largest number of pixels any character kerns, that is, the 
distance from the character origin to the left edge of the font rectangle. It 
should always be 0 or negative, since the kerned pixels are to the left of the 
character origin. NDescent is the negative of the descent (the distance from the 
character origin to the bottom of the font rectangle). 


The owTLoc field contains a word offset from itself to the offset/width table; 
it's equivalent to 


4 + (rowwords * fRectHeight) + (lastChar—firstChar+3) + 1 
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Warning: Remember, the offset and row width in a font record are 
given in words, not bytes. 


Assembly-language note: The global variable ROMFont® contains a handle 
to the font record for the system font. 


Every size of a font is stored as a separate resource. The resource type for a 


font is 'FONT'. The resource data for a font is simply a font record: 
Number of bytes Contents 
2 bytes FontType field of font record 
2 bytes FirstChar field of font record 
2 bytes LastChar field of font record 
2 bytes WidMax field of font record 
2 bytes KernMax field of font record 
2 bytes NDescent field of font record 
2 bytes FRectWidth field of font record 
2 bytes FRectHeight field of font record 
2 bytes OWTLoc field of font record 
2 bytes Ascent field of font record 
2 bytes Descent field of font record 
2 bytes Leading field of font record 
2 bytes RowWwords field of font record 
n bytes Bit image of font 
n = 2 * rowWords * fRectHeight 
m bytes Location table of font 
m= 2 * (lastChar—firstChar+3) 
m bytes Offset/width table of font 


m= 2 * (lLastChar—firstChar+3) 


As shown in Figure 10, the resource ID of a font has the following format: Bits 
0-6 are the font size, bits 7-14 are the font number, and bit 15 is 0. Thus the 
resource ID corresponding to a given font number and size is 


(128 * font number) + font size 
eeeClick on the X-Ref button, and refer to Technical Note #245. eee 
Since 0 is not a valid font size, the resource ID having 0 in the size field is 
used to provide only the name of the font: The name of the resource is the font 
name. For example, for a font named Griffin and numbered 200, the resource 


naming the font would have a resource ID of 25600 and the resource name 
'Griffin'. Size 10 of that font would be stored in a resource numbered 25610. 


15 id v6 0 


[[ fan [ee 


Figure 10—Resource ID for a Font 
Figure 10-Resource ID for a Font 


The resource type 'FRSV' is reserved by the Font Manager; it identifies fonts 
used by the system. Fonts whose resource IDs are contained in a 'FRSV' resource 
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1 will not be removed from the system resource file by the Font/DA Mover. The 
format of a 'FRSV' resource is as follows: 


Number of bytes Contents 
2 bytes Number of font resource IDs 
n * 2 bytes n font resource IDs 


Font Widths 


A resource type can be defined that consists of only the character widths and 
general font information—everything but the font's bit image and location table. 
If this 'FWID' resource type exists, it will be read in whenever QuickDraw 
doesn't need to draw the text, such as when you call one of the routines 
CharWidth, HidePen, or OpenPicture (which calls HidePen). The FontRec data type 
described above, minus the rowWords, bitImage, and locTable fields, reflects the 
structure of the 'FWID' resource type. The owTLoc field will contain 4, and the 
fontType field will contain the following predefined constant: 


CONST fontWid = $ACBO; {font width data} 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


To maintain compatibility with existing applications, the order of the fields in 
the font record remains unchanged; two variable-length arrays are added at the 
end of the record, however, to implement fractional character widths. 


Number of bytes Contents 
m bytes Optional character-width table of font 
m= 2 * (lastChar—firstChar+3) 
m bytes Optional image-height table of font 


m= 2 * (lLastChar—firstChar+3) 


The various sizes of a font are each stored as separate resources. The resource 
type for a font is either 'FONT' or 'NFNT', which is simply the original font 
record with the two additional variable-length arrays added at the end of the 
record. 


Additional constants have been defined for use in the fontType field; it can now 
contain any of the following values: 


CONST propFont = $9000; {proportional font} 
prpFntH = $9001; { with height table} 
prpFntw = $9002; { with width table} 
prpFntHW = $9003; { with height & width tables} 
fixedFont = $B000; {fixed-width font} 
fxdFntH = $B001; { with height table} 
fxdFntw = $B002; { with width table} 
fxdFntHw = $B003; { with height & width tables} 
fontwid = $ACBO; {font width data: 64K ROM only} 
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The low-order two bits of the fontType field tell whether the two optional 
tables are present. If bit 0 is set, there's an image-height table; if bit 1 is 
set, there's a character width table. 


The optional character-width table immediately follows the offset/width table; 
it's a variable-length array specifying the fixed-point character widths for 
each character in the font. Each entry is a word in length. For compactness, a 
special 16-bit fixed-point format is used with an unsigned integer part in the 
high-order byte and a fractional part in the low-order byte. 


eeeClick on the X-Ref button, and refer to Technical Note #30.¢e« 


The optional image-height table, which speeds the drawing of characters, may 
also be appended after the character-width table; it's a variable-length array 
specifying the image height of each character in the font. Each entry is a word 
in length; the high-order byte is the offset of the first non-white row in the 
character; the low-order byte is the number of rows that must be drawn. The 
image height is the height of the character image and is less than or equal to 
the font height; it's used in conjunction with QuickDraw for improved character 
plotting. Most font resources don't contain this table; it's typically generated 
by the Font Manager when the font is swapped in. 


Note: The 64K ROM version of the Resource Manager limits the total space 
occupied by the bit image, location table, offset/width table, and 
character-width and image-height tables to 32K bytes. For this reason, 
the practical limit on the font size of a full font is about 40 points. 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


Several previously unused bits of the fontType field specify the font depth and 
other related information (the new bits are marked by an asterisk): 


Bit Meaning 


0 Set if there's an image-height table 

1 Set if there's a character-width table 

* 2-3 Font depth (Macintosh II only—must be 0 otherwise) 

4-6 Reserved (should be 0) 
7 Set if font has an 'fctb' resource (Macintosh II 

only—must be © otherwise) 

* 8 Set if a synthetic font (Macintosh II only—must be 0 otherwise) 
9 Set if font contains colors other than black (Macintosh II 

only—must be © otherwise) 
10-11 Reserved (should be 0) 


12 Reserved (should be 1) 
13 Set for fixed-width font, clear for proportional font 
* 14 Set if font is not to be expanded (Macintosh II 
only—must be 0 otherwise) 
15 Reserved (should be 1) 


Bit 2 and 3 specify the font depth and can contain the following values: 
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Value Font depth 


0 1-bit 
1 2-bit 
2 4-bit 
3 8-bit 


The font depth is normally 0, indicating a font intended for a screen one bit 
deep. If bit 7 is set (and the font is an 'NFNT' resource), a resource of type 
'fctb' with the same ID as the font can optionally be provided to assign RGB 
colors to specific pixel values. 


Bit 8 is used only by the Font Manager to indicate a synthetic font, created 
dynamically from the available font resources in response to a certain color and 
screen depth combination. 


Bit 9 is set if the font contains other than black. 


Setting bit 14 indicates that the font should not be expanded by the Font 
Manager to match the screen depth; some international fonts, such as kanji, are 
too large for synthetic fonts to be effective or meaningful. 


To accommodate multibit font depths, the owTLoc field has been changed to a long 
word, the nDescent field becoming the high-order word. (For backward 
compatibility, nDescent is ignored if it's negative. ) 


Note: The 128K ROM version of the Font Manager limits the strike for a 
1-bit font to not quite 128K; this limits the largest practical 
font to about 127 points. The Macintosh II ROM limits the largest 
practical font to about 255 points, regardless of the font depth. 


Family Records 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


Assembly-language note: The global variable LastFOND is a handle to the last 
family record used. You can read the contents of the 
family record by using this handle. You should not 
alter the contents of this record. 

The data type for a family record is as follows: 


TYPE FamRec = RECORD 


ffFlags: INTEGER; {flags for family} 

ffFamID: INTEGER; {family ID number} 

ffFirstChar: INTEGER; {ASCII code of the first character} 
ffLastChar: INTEGER; {ASCII code of the last character} 
ffAscent: INTEGER; {maximum ascent for 1-pt.font} 
ffDescent: INTEGER; {maximum descent for 1-pt. font} 
ffLeading: INTEGER; {maximum leading for 1-pt. font} 
ffWidMax: INTEGER; {maximum width for 1-pt. font} 
ffWTabOff: LONGINT; {offset to width table} 


@ SpInside Macintosh * Version 1.0 * November 1989 * Apple Computer 
THE FONT MANAGER ¢ 23 of 54 


ffKernOff: LONGINT; {offset to kerning table} 


FfFStylorff: LONGINT; {offset to style-mapping table} 
ffProperty: ARRAY[1..9] OF INTEGER; {style property info} 
ffIntl: ARRAY[1..2] OF INTEGER; {reserved} 
ffVersion: INTEGER; {version number} 

{ ffAssoc: FontAssoc;} {font association table} 

{ ffWidthTab: WidTable;} {width table} 

{ ffStyTab: StyleTable;}{style-mapping table} 

{ ffKernTab: KernTable;} {kerning table} 

END; 


Note: The variable-length arrays appear as comments because they're not 
valid Pascal syntax; they're used only as conceptual aids. This 
version of the FamRec is accurate for Volume IV; the extensions to 
the FamRec made in Volume V are not included here. 


The ffFlags field defines general characteristics of the font family, as 
follows: 


Bit Meaning 

0 Set if there's an image-height table 

1 Set if there's a character-width table 

2-11 Reserved (should be zero) 

12 Set to ignore FractEnable when deciding whether to use 


fixed-point values for stylistic variations (see bit 13), 
clear to treat FractEnable as usual 

13 Set to use integer extra width for stylistic variations, 
clear to compute fixed-point extra width from the family 
style-mapping table when FractEnable is TRUE 


14 Set if family fractional-width table is not used, clear 
if table is used 
15 Set for fixed-width font, clear for proportional font 


The values in the ffAscent, ffDescent, ffLeading, and ffWidMax describe the 
maximum dimensions of the family as they would be for a hypothetical one-point 
font to be scaled up. They use a special 16-bit fixed-point format with an 
integer part in the high-order 4 bits and a fractional part in the low-order 12 
bits. The FontMetrics procedure calculates the true values by multiplying this 
number by the actual point size. 


The ffwlabOff, ffkKernOff, and ffStylOff fields are offsets from the top of the 
record to the start of the width table, kerning table, and style-mapping table, 
respectively; if any of these fields is zero, the corresponding table does not 
exist. 


The ffProperty field is the family style-property table, shown in Figure 11. 
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Extra width for Plain text - set bo O [word] 
Extra width for Bold text [word] 
Extra width for Italie text [word] 


Hot used - set to 0 [word] 


Figure 11-Family Style-Property Table 
Figure 11—-Family Style-Property Table 


Each entry is a 16-bit fixed-point number with a signed integer part in the 
high-order 4 bits and a fractional part in the low-order 12 bits. These numbers 
are used to calculate the amount of extra width for special stylistic 
variations; each of these values is multiplied by the point size of the font 
actually being used. If the font already exists for a given style, the value in 
its field is ignored. 


The ffAssoc field contains the font association table. This table, shown in 
Figure 12, is used to match a given font size and style combination with the 
resource ID of an actual font. 


Humber of entries - 1 [word] 
First FOWMT entry [6 bytes) 
Becond FONT entry (6 bytes] 


Figure 12-Font Association Table 
Figure 12—Font Association Table 


Note: In order to reduce search time, the Font Manager requires that 
the entries be sorted according to the fontSize field, with the 
smallest sizes first. If multiple fonts from the same family, the 
plain (roman) fonts come first. The Font Manager is optimized to 
look first for 'NFNT' resources, then 'FONT' resources. 


Each entry in the font association table has the format shown in Figure 13. 
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Font style [word] 


Fesource ID of associated 
PONT resources [word] 


Figure 13-Font Association Table Entry 


Figure 13—Font Association Table Entry 


The font association table is followed by the family character-width table. As 
shown in Figure 14, this table is actually a number of width tables (since a 
font family may include numerous styles). 


Mumber of widthtables - 1 [word] 
Bhyle code [word] 


First widthtable 


Bhyle code [word] 


Becond width table 


Figure 14-Family Character-Width Table 
Figure 14—Family Character-Width Table 


Each character-width table is preceded by a style code; the low-order byte of 
this word specifies stylistic variations (see Figure 15). The widths in each 
table are for a hypothetical one-point font; the actual values for the 
characters are calculated by multiplying these widths by the font size. The 
widths in this table are stored in a 16-bit fixed-point format with an unsigned 
integer part in the high-order 4 bits and a fractional part in the low-order 12 
bits. 
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7 6 35 4 3 21 0 


1 For Bold style selected 


1 For Italic style selected 
1 For Underline style selected 


1 For Gutline style selected 
1 For Shadow style selected 


1 For Condensed style selected 
1 For Extended style selected 


x Reserved Cor we by the Font Manager 


Figure 15-Style Codes 
Figure 15-Style Codes 


The style-mapping table and its associated tables are used by the LaserWriter 
driver and are described in the Apple LaserWriter Reference. 


The kerning table, like the family character-width table, is actually a number 
of kerning tables (see Figure 16). 


Humber of kerning tables - 1 [word] 
First kerning table 
Becond keris table 


Figure 16-Rerming Table 
Figure 16—Kerning Table 


Each kerning table is preceded by a style code; stored in the low-order byte of 
the word, this style information has the same format shown in Figure 15 above. 
The number of entries in the table follows the style word (see Figure 17). 
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Bhyle code [word] 
Mumber of entries (word) 


First kermimgy pair entry [4 bytes] 


Becond keris pair entry [4 bytes] 


Figure 17-Strocture of a Reming Table 


Figure 17-Structure of a Kerning Table 


The entries in each kerning table (shown in Figure 18) consist of a pair of 
characters followed by a kerning offset for a hypothetical one-point font. This 
value, represented by an integer part in the high-order 4 bits and a fractional 
part in the low-order 12 bits, is multiplied by the size of the font to obtain 
the actual offset. 


First character of kerning pair [byte] 
Becond character of kerning pair [byte] 


Ferning offset [word] 


Figure 136-—Keming Table Entry 
Figure 18—-Kerning Table Entry 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


For Macintosh II only, bits 8 and 9 of the font style word within each font 
association table specify the font depth; they must contain the same value as 
bits 2 and 3 of the fontType field of the font record. All other undefined bits 
remain 0. 


A font family is stored as a resource of type 'FOND', and with the Macintosh II, 
it's format has been extended. The new format is the following (with extension 
fields indicated by asterisks): 


Number of bytes Contents 
2 bytes FONDFlags field of family record 
2 bytes FONDFamID field of family record 
2 bytes FONDFirst field of family record 
2 bytes FONDLast field of family record 
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2 bytes FONDAscent field of family record 

2 bytes FONDDescent field of family record 

2 bytes FONDLeading field of family record 

2 bytes FONDWidMax field of family record 

4 bytes FONDWTabOff of family record 

4 bytes FONDKernOff of family record 

4 bytes FONDStylOff of family record 

24 bytes FONDProperty field of family record 

4 bytes FONDIntl field of family record 

2 bytes *Version number ($02) 

m bytes FONDAssoc field of family record (variable length) 

2 bytes *Number of offsets minus 1 

4 bytes *Offset to bounding box table 

n bytes *Bounding box table 

p bytes FONDWidTable field of family record (variable length) 
q bytes FONDStylTab field of family record (variable length) 
r bytes FONDKerntab field of family record (variable length) 


The bounding box table has an entry for each style available in the family. The 
table as a whole has this form: 


Number of bytes Contents 
2 bytes Number of entries minus 1 
10 bytes First entry 
10 bytes Second entry . 


Each bounding box entry has this form, giving the bounding box position with 
respect to the origin of the characters: 


Number of bytes Contents 
2 bytes Style word 
2 bytes Lower left x coordinate 
2 bytes Lower left y coordinate 
2 bytes Upper right x coordinate 
2 bytes Upper right y coordinate 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


Restrictions on the 'FONT' Type 


For backward compatibility, all 'FONT' resources that are part of a 'FOND' have 
certain restrictions: 


1. The font name and family name must be identical. 

2. The font number and family number must be identical since the 
Font Manager interprets a family number as a font number. 

3. The resource ID of the font must be the same number that would 
be produced by concatenating the font number and the font size. 


These restrictions ensure that both the 64K ROM and 128K ROM versions of the 
Font Manager will associate the family number and point size with the proper 
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corresponding font resource ID, whether or not there's a family resource. 'NFNT' 
resources are not bound by these restrictions (but neither will they be found by 
the 64K ROM version of the Font Manager). 


Global Width Tables 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


The Font Manager communicates fractional character widths to QuickDraw via a 
global width table, a data structure allocated in the system heap. A handle to 
the global width table is returned by the FontMetrics procedure. The format of 
the global width table is follows: 


TYPE WidthTable = RECORD 
tabData: ARRAY[1..256] OF Fixed; { character widths} 
tabFont: Handle; {font record used to build table} 
sExtra: LONGINT; {space extra used for table} 


style: LONGINT; {extra due to style} 

FID: INTEGER; {font family ID} 

fSize: INTEGER; {font size request} 

face: INTEGER; {style (face) request} 

device: INTEGER; {device requested} 

inNumer: Point; {numerators of scaling factors} 
inDenom: Point; {denominators of scaling factors} 
aFID: INTEGER; {actual font family ID for table} 
fHand: handle; {family record used to build table} 
usedFam: BOOLEAN; {used fixed-point family widths} 
aFace: Byte; factual face produced} 


vOutput: INTEGER; {vertical factor for expanding } 
{ characters} 

hOutput: INTEGER; {horizontal factor for expanding } 
{ characters} 

vFactor: INTEGER; {not used} 

hFactor: INTEGER; {horizontal factor for increasing } 
{ character widths} 


aSize: INTEGER; {actual size of actual font used} 
tabSize: INTEGER {total size of table} 
END; 


TabData is an array containing a character width for each of the 255 possible 
characters in a font, plus one long word for the font's missing symbol. The 
widths are stored in the standard 32-bit fixed-point format. If a character is 
missing, its entry contains the width of the missing symbol. (For efficiency, 
the Font Manager will store up to 12 recently used global width tables.) InNumer 
and inDenom contain the vertical and horizontal scaling factors copied from the 
font input record. 


Scaling is effected in two ways: by expanding characters of the chosen font and 
by artificially increasing the widths of the chosen font in the width table. 
HOutput and vOutput give the factors by which characters are to be expanded 
horizontally and vertically. HFactor is the factor by which the widths of the 


@ SpInside Macintosh ¢ Version 1.0 * November 1989 * Apple Computer 
THE FONT MANAGER ¢« 30 of 54 


chosen font, after stylistic variations, have been increased. (VFactor is not 
used.) Thus, multiplying hOutput and vOutput by hFactor and vFactor gives the 
true font scaling; the product of hOutput and an entry in the width table is 
that character's true scaled width. HOutput,vOutput, hFactor, and vFactor are 
all 16-bit fixed-point numbers, with an integer part in the high-order byte and 
a fractional part in the low-order byte. 


If font scaling has been enabled, hFactor and vFactor both have a value of 1. In 
any case, hOutput, vOutput, hFactor, and vFactor are adjusted so that the values 
of hFactor and vFactor lie between 1 and 2, including 1. 


Assembly-language note: A handle to the global width table is contained 
in the global variable WidthTabHandle. A pointer 
to the table is contained in the global variable 
WidthPtr; it's reliable immediately after a call 
to FMSwapFont but, like all pointers, may become 
invalid after a call to the Memory Manager. 


The global variable WidthListHand is a handle to a 
list of handles to up to 12 recently-used width 
tables. You can scan this list, looking for width 
tables that match the family number, size, and style 
of the font you wish to measure. If you reach a width 
handle that's equal to —1, that width table is 
invalid, and you must make an FMSwapFont call to 

get a valid one. When you reach a handle that's zero, 
you've reached the end of the list. 


You should not use the global width table when 
special international interface software is being 
used to accommodate non-Roman alphabets. You can 
recognize such software by looking at the global 
variable IntlSpec; if it's greater than 0, special 
international software is installed. If your 
application uses non-Roman alphabets, write to 


Developer Technical Support 
Apple Computer, Inc. 

20525 Mariani Avenue, M/S 75-3T 
Cupertino, CA 95014 


for the latest version of the International Utilities 
Package, which will be extended to handle non-Roman 
alphabets. 


Font Color Tables 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


With resources of type 'NFNT', you can specify absolute colors for the font by 
also supplying a color table. Stored as a resource of type 'fctb' with the same 
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ID as the associated 'NFNT' resource, this table is simply the ColorTable record 
described in the Color Manager chapter. 


A 4-bit font depth provides index values for a color table containing 16 
entries. If there are index values for which no corresponding entries are found 
in the associated color table, the Font Manager assigns colors based on the 
current port's foreground and background colors. If only one entry is missing, 
it's assigned the background color. If two entries are missing, the higher 
index value is assigned the foreground color and the lower value is given the 
background color. If more than two values are missing, the entries are given 
shades ranging between the foreground and background colors. Figure 19 shows a 
hypothetical color table for a 2-bit font in which only five entries have been 
supplied in the 'fctb' resource. 


Foreground eolor 


Lid foregd, 12 backgd 
Background color 


Figure 19-H ypothetical Font Color Table Entries 
Figure 19-Hypothetical Font Color Table Entries 


If no color table is provided, the highest and lowest possible index values for 
any given screen depth (with a 2-bit screen depth, for example, values 7 and 0) 
are assigned the foreground and background colors respectively, with the 
remaining entries given shades in between. This allows gray-scale fonts to be 
created with as many levels of gray as are needed (Since each gray is just a 
color in between a foreground of black and a background of white) without 
needing a color table. 
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CHARACTERS IN A FONT 


Note: The information on the Characters In A Font described in the following 
paragraphs was originally documented in Inside Macintosh, Volume I. 


A font can consist of up to 255 distinct characters; not all characters need to 
be defined in a single font. Figure 20 shows the standard printing characters on 
the Macintosh and their ASCII codes (for example, the ASCII code for "A" is 41 
hexadecimal, or 65 decimal). 


Note: Codes $00 through $1F and code $7F are normally nonprinting 
characters (see the Toolbox Event Manager chapter for details). 


The special characters in the system font with codes $11 through $14 can't 
normally be typed from the keyboard or keypad. The Font Manager defines 
constants for these characters: 


CONST commandMark = $11; {Command key symbol} 
checkMark = $12; {check mark} 
diamondMark = $13; {diamond symbol} 
appleMark = $14; {apple symbol} 


In addition to its maximum of 255 characters, every font contains a missing 
symbol that's drawn in case of a request to draw a character that's missing from 
the font. 
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First Digit 


L—stands for a nonbreaking space, the same width as a digit. 
The first four characters are only in the system foot [Chicago]. 
The shaded characters are not in all Fouts. 

Codes $D9 through $FF are reserved for future expansion. 


Figure 20-—Font Characters 
Figure 20—Font Characters 
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COMMUNICATION BETWEEN QUICKDRAW AND THE FONT MANAGER 


This section describes the data structures that allow QuickDraw and the Font 
Manager to exchange information. It also discusses the communication that may 
occur between the Font Manager and the driver of the device on which the 
characters are being drawn or printed. You can skip this section if you want to 
change fonts, character style, and font sizes by calling QuickDraw and aren't 
interested in the lower-level data structures and routines of the Font Manager. 
To understand this section fully, you'll have to be familiar with device drivers 
and the Device Manager. 


Whenever you call a QuickDraw routine that does anything with text, QuickDraw 
requests information from the Font Manager about the characters. The Font 
Manager performs any necessary calculations and returns the requested 
information to QuickDraw. As illustrated in Figure 21, this information exchange 
occurs via two data structures, a font input record (type FMInput) and a font 
output record (type FMOutput). 


First, QuickDraw passes the Font Manager a font input record: 


TYPE FMInput = PACKED RECORD 


family: INTEGER; {font number} 

size: INTEGER; {font size} 

face: Style; {character style} 

needBits: BOOLEAN; {TRUE if drawing} 

device: INTEGER; {device-specific information} 

numer: Point; {numerators of scaling factors} 

denom: Point {denominators of scaling factors} 
END; 


The first three fields contain the font number, size, and character style that 
QuickDraw wants to use. 


The needBits field indicates whether the characters actually will be drawn or 
not. If the characters are being drawn, all of the information describing the 
font, including the bit image comprising the characters, will be read into 
memory. If the characters aren't being drawn and there's a resource consisting 
of only the character widths and general font information, that resource will be 
read instead. 


The high-order byte of the device field contains a device driver reference 
number. From the driver reference number, the Font Manager can determine the 
optimum stylistic variations on the font to produce the highest-quality printing 
or drawing available on a device (as explained below). The low-order byte of the 
device field is ignored by the Font Manager but may contain information used by 
the device driver. 
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font 
characterization : 
i table : 
: Control Call 


Final TMhodifications 


Figure 21-—Communication About Fonts 


Figure 21—Communication About Fonts 


The numer and denom fields contain the scaling factors to be used; numer.v 
divided by denom.v gives the vertical scaling, and numer.h divided by denom.h 
gives the horizontal scaling. 


The Font Manager takes the font input record and asks the Resource Manager for 
the font. If the requested size isn't available, the Font Manager scales another 
size to match (as described under "Font Scaling"). 


Then the Font Manager gets the font characterization table via the device field. 
If the high-order byte of the device field is 0, the Font Manager gets the 
screen's font characterization table (which is stored in the Font Manager). If 
the high-order byte of the device field is nonzero, the Font Manager calls the 
status routine of the device driver having that reference number, and the status 
routine returns a font characterization table. The status routine may use the 
value of the low-order byte of the device field to determine the font 
characterization table it should return. 


Note: If you want to make your own calls to the device driver's Status 
function, the reference number must be the driver reference number 
from the font input record's device field, csCode must be 8, csParam 
must be a pointer to where the device driver should put the font 
characterization table, and csParam+4 must be an integer containing 
the value of the font input record's device field. 


Figure 22 shows the structure of a font characterization table and, on the 
right, the values it contains for the Macintosh screen. 
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Figure 22—-Font Characterization Table 


Figure 22—Font Characterization Table 


The first two words of the font characterization table contain the approximate 
number of dots per inch on the device. These values are only used for scaling 
between devices; they don't necessarily correspond to a device's actual 
resolution. 


The remainder of the table consists of three-byte triplets providing information 
about the different stylistic variations. For all but the triplet defining the 
underline characteristics: 


e The first byte in the triplet indicates which byte beyond the bold 
field of the font output record (see below) is affected by the triplet. 

* The second byte contains the amount to be stored in the affected field. 

e The third byte indicates the amount by which the extra field of the 
font output record is to be incremented (starting from 0). 


The triplet defining the underline characteristics indicates the amount by which 
the font output record's ulOffset, ulShadow, and ulThick fields 
(respectively) should be incremented. 


Based on the information in the font characterization table, the Font Manager 
determines the optimum ascent, descent, and leading, so that the highest-quality 
printing or drawing available will be produced. It then stores this information 
in a font output record: 


TYPE FMOutput = PACKED RECORD 


errNum: INTEGER; {not used} 

fontHandle: Handle; {handle to font record} 
bold: Byte; {bold factor} 

italic: Byte; {italic factor} 
ulOffset: Byte; {underline offset} 
ulShadow: Byte; {underline shadow} 
ulThick: Byte; {underline thickness} 
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shadow: Byte; {shadow factor} 


extra: SignedByte; {width of style} 

ascent: Byte; {ascent} 

descent: Byte; {descent} 

widMax: Byte; {maximum character width} 

leading: SignedByte; {leading} 

unused: Byte; {not used} 

numer: Point; {numerators of scaling factors} 

denom: Point {denominators of scaling factors} 
END; 


ErrNum is reserved for future use, and is set to 0. FontHandle is a handle to 
the font record of the font, as described in the next section. Bold, italic, 
ulOffset, ulShadow, ulThick, and shadow are all fields that modify the way 
stylistic variations are done; their values are taken from the font 
characterization table, and are used by QuickDraw. (You'll need to experiment 
with these values if you want to determine exactly how they're used.) Extra 
indicates the number of pixels that each character has been widened by stylistic 
variation. For example, using the screen values shown in Figure 22, the extra 
field for bold shadowed characters would be 3. Ascent, descent, widMax, and 
leading are the same as the fields of the FontInfo record returned by the 
QuickDraw procedure GetFontInfo. Numer and denom contain the scaling factors. 


Just before returning this record to QuickDraw, the Font Manager calls the 
device driver's control routine to allow the driver to make any final 
modifications to the record. Finally, the font information is returned to 
QuickDraw via a pointer to the record, defined as follows: 


TYPE FMOutPtr = *FMOutput; 


Note: If you want to make your own calls to the device driver's Control 
function, the reference number must be the driver reference number 
from the font input record's device field, csCode must be 8, csParam 
must be a pointer to the font output record, and csParam+4 must be 
the value of the font input record's device field. 


Font Search Algorithm 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


The basic structure of the font input and output records passed between 
QuickDraw and the Font Manager is unchanged. 


Note: Advanced programmers who use the FMSwapFont function should be aware 
that the Font Manager may attach optional tables to the font output 
record it returns. 


The information QuickDraw passes to the Font Manager includes the font or family 
number, the font size, and the scaling factors QuickDraw wants to use; the 
search for an appropriate font is as follows. 
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The Font Manager first looks for a 'FOND' resource matching the ID of the 
requested font or font family. It if finds one, it searches the family 
record's font association table (detailed below) for an 'NFNT' or 'FONT' 
resource matching the requested style and size. It it can match the size but 
not the style, it returns a font that matches as many properties as possible, 
giving priority first to italic, then to bold. QuickDraw must then add any 
needed stylistic variations (using the information passed in the bold, italic, 
ulOffset, ulShadow, ulThick, and shadow fields of the font output record). 


If the Font Manager can't find a 'FOND' resource, it looks for a 'FONT' resource 
with the requested font number and size. (It doesn't look for an 'NFNT' resource 
Since these occur only in conjunction with 'FOND' resources.) 


If the Font Manager cannot find a font for a particular style, the font Manager 
and QuickDraw derive a font (as in the 64K ROM version). 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


When passed a font request, the Font Manager takes a number of steps to provide 
the desired font; if the font can't be found, it looks for other fonts with 
which to fill the request. The search order is as follows: 


¢ a 'FOND' resource. It first checks the last used 'FOND', then checks 
the most recently-used width tables (a handle to them is contained in 
the global variable WidthListHand), and finally calls GetResource 
(looking through the chain of open resource files, beginning with the 
application resource file). The width table it checks is that of the 
nearest size and font that it found. 

* a 'FONT' resource without a corresponding 'FOND' (again calling 
GetResource) 

e the application font 

* a "neighborhood" base font. For fonts numbered below 4096, the 
neighborhood base font is 0. For fonts numbered 4096 and above, it 
is the next lower font whose number is a multiple of 512. 

e the system font 

e the Chicago 12 font 


Font Scaling 


Note: The information on Font Scaling described in the following paragraphs 
was originally documented in Inside Macintosh, Volume I. 


The information QuickDraw passes to the Font Manager includes the font size and 
the scaling factors QuickDraw wants to use. The Font Manager determines the font 
information it will return to QuickDraw by looking for the exact size needed 
among the sizes stored for the font. If the exact size requested isn't 
available, it then looks for a nearby size that it can scale, as follows: 


1. It looks first for a font that's twice the size, and scales down 
that size if there is one. 
2. If there's no font that's twice the size, it looks for a font 


@ SpInside Macintosh ¢ Version 1.0 * November 1989 * Apple Computer 
THE FONT MANAGER ¢« 39 of 54 


that's half the size, and scales up that size if there is one. 
3. If there's no font that's half the size, it looks for a larger 
Size of the font, and scales down the next larger size if there is one. 
4. If there's no larger size, it looks for a smaller size of the font, 
and scales up the closest smaller size if there is one. 
5. If the font isn't available in any size at all, it uses the 
application font instead, scaling the font to the size requested. 
6. If the application font isn't available in any size at all, it uses 
the system font instead, scaling the font to the size requested. 


Scaling looks best when the scaled size is an even multiple of an available 
size. 


Assembly-language note: You can use the global variable FScaleDisable to 
disable scaling, if desired. Normally, FScaleDisable 
is 0. If you set it to a nonzero value, the Font 
Manager will look for the size as described above 
but will return the font unscaled. 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


If the Font Manager can't find a font of the requested size and font scaling is 
enabled, it follows the standard scaling algorithm with one exception: If it 
can't find a font that's double or half the requested size, it looks for the 
font that's closest to the request size, either larger or smaller. 


If it can't find a font of the requested size and font scaling is disabled, the 
Font Manager looks for a smaller font closest to the requested size and returns 
with it with the widths for the requested size. Thus, QuickDraw draws the 
smaller font with the spacing of the larger, requested font. This is generally 
preferable to font scaling since it's faster and more readable. Also, it 
accurately mirrors the word spacing and line breaks that the document will have 
when printed, especially if fractional character widths are used. 


Fractional Character Widths 


The use of fractional character widths allows more accurate character placement 
on high-resolution output devices such as the LaserWriter. It also enables 
character placement on the screen to match more closely that on the LaserWriter 
(although QuickDraw cannot actually draw a letter 3.5 pixels wide, for 
instance). The Font Manager will, however, store the locations of characters 
more accurately than any particular screen can display. Given exact widths for 
characters, words, and lines, the LaserWriter can print faster and give better 
Spacing. A price must be paid, however; since screen characters are made up of 
whole pixels, spacing between characters and words will be uneven as the 
fractional parts are rounded off. The extent of the distortion depends on the 
font size relative to the screen resolution. 


The Font Manager communicates fractional character widths QuickDraw via the 
global width table, a data structure allocated in the system heap. The Font 
Manager gathers the width data for this table from one of three data structures. 
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Warning: You should always obtain character widths from the global width 
table since you can't really know where the Font Manager obtained 
the width information from. A handle to the global width table is 
returned by the FontMetrics procedure. 


First, it looks for a font character-width table in the font record. In this 
table, the actual widths of each character in the font are stored in a 16-bit 
fixed-point format with an integer part in the high-order byte and a fractional 
part in the low-order byte. 


If it doesn't find this table, it looks in the family record for a family 
character-width table. For each font in the family, this table contains the 
fractional widths for every character as if a hypothetical one-point font; the 
actual values for the characters are calculated by multiplying these widths by 
the font size. The widths in this table are stored in a 16-bit fixed-point 
format with an integer part in the high-order 4 bits and a fractional part in 
the low-order 12 bits. 


If no family character-width table is found, the global character widths are 
derived from the integer widths contained in the offset/width table in the font 
record. 


To use fractional character widths effectively, an application must get accurate 
widths for the characters, either by using the QuickDraw routine MeasureText or 
by looking in the global width table. 


Warning: Applications that derive their own character widths may not 
function properly when fractional widths are enabled. 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume V. As such, 
this information refers to the Macintosh SE and Macintosh II ROMs and 
System file version 4.1 and later. 


Two cautionary points about how the Font Manager communcates character widths 
should be added: 


¢ A font request made with scaling disabled will not necessarily return 
the same result as an identical request with scaling enabled. The widths 
are sure to be the same only if fractional widths are enabled, and if 
the font does not have a font character-width table and is a member of 
a family record with a family character-width table. 

e A font request with either twice the point size or a numerator/denominator 
scale factor of 2 is not guaranteed to double the widths of the characters 
exactly. Instead, the widths returned accurately describe how QuickDraw 
measures and spaces the characters. This is especially noticeable for 
algorithmically-applied style modifications like boldfacing. Boldfacing 
makes the character strike one pixel wider, regardless of point size. A 
font with a family character-width table, however, describes the spacing 
of the characters correctly. 


To cause two different font requests to measure the same, or proportionately, 
use the QuickDraw routines SpaceExtra and CharExtra to adjust the widths of the 
Spaces and other characters. In most cases, it's sufficient to simply pass the 
difference of the two measures divided by the number of spaces on the line to 
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SpaceExtra. If the difference is too large or small, or if the line does not 
contain any spaces, you can adjust the line length with the CharExtra routine. 


How QuickDraw Draws Text 


Note: The information on How QuickDraw Draws Text described in the following 
paragraphs was originally documented in Inside Macintosh, Volume I. 


This section provides a conceptual discussion of the steps QuickDraw takes to 
draw characters (without scaling or stylistic variations such as bold and 
outline). Basically, QuickDraw simply copies the character image onto the 
drawing area at a specific location. 


1. Take the initial pen location as the character origin for the 
first character. 

2. In the offset/width table, check the word for the character to 
see if it's -1. 

2a. The character exists if the entry in the offset/width table 
isn't —1. Determine the character offset and character width 
from this entry. Find the character image at the location in 
the bit image specified by the location table. Calculate the 
image width by subtracting this word from the succeeding word 
in the location table. Determine the number of pixels the 
character kerns by adding kernMax to the character offset. 

2b. The character is missing if the entry in the offset/width table 
is -1; information about the missing symbol is needed. Determine 
the missing symbol's character offset and character width from 
the next-to-last word in the offset/width table. Find the missing 
symbol at the location in the bit image specified by the next-to-last 
word in the location table. Calculate the image width by subtracting 
the next-to-last word in the location table from the last word in 
the table. Determine the number of pixels the missing symbol kerns 
by adding kernMax to the character offset. 

3. If the fontType field is fontWid, return to step 2; otherwise, copy 
each row of the character image onto the drawing area, one row at a 
time. The number of bits to copy from each word is given by the image 
width, and the number of words is given by the fRectHeight field. 

4. If the fontType field is propFont, move the pen to the right the 
number of pixels specified by the character width. If fontType is 
fixedFont, move the pen to the right the number of pixels specified 
by the widMax field. 

5. Return to step 2. 
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USING THE FONT MANAGER 


The InitFonts procedure initializes the Font Manager; you should call it after 
initializing QuickDraw but before initializing the Window Manager. 


You can set up a menu of fonts in your application by using the Menu Manager 
procedure AddResMenu (see the Menu Manager chapter for details). When the user 
chooses a menu item from the font menu, call the Menu Manager procedure GetItem 
to get the name of the corresponding font, and then the Font Manager function 
GetFNum to get the font number. The GetFontName function does the reverse of 
GetFNum: Given a font number, it returns the font name. 


In a menu of font sizes in your application, you may want to let the user know 
which sizes the current font is available in and therefore will not require 
scaling (this is usually done by showing those font sizes outlined in the menu). 
You can call the RealFont function to find out whether a font is available ina 
given size. 


If you know you'll be using a font a lot and don't want it to be purged, you can 
use the SetFontLock procedure to make the font unpurgeable during that time. 


Advanced programmers who want to write their own font editors or otherwise 
manipulate fonts can access fonts directly with the FMSwapFont function. 
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FONT MANAGER ROUTINES 


Initializing the Font Manager 
PROCEDURE InitFonts; 


InitFonts initializes the Font Manager. If the system font isn't already in 
memory, InitFonts reads it into memory. Call this procedure once before all 
other Font Manager routines or any Toolbox routine that will call the Font 
Manager. 


Getting Font Information 


Warning: Before returning, the routines in this section issue the Resource 
Manager call SetResLoad(TRUE). If your program previously called 
SetResLoad(FALSE) and you still want that to be in effect after 
calling one of these Font Manager routines, you'll have to call 
SetResLoad(FALSE) again. 


PROCEDURE GetFontName (fontNum: INTEGER; VAR theName: Str255); 


Assembly-language note: The macro you invoke to call GetFontName from 
assembly Language is named GetFName. 


GetFontName returns in theName the name of the font having the font number 
fontNum. If there's no such font, GetFontName returns the empty string. 


PROCEDURE GetFNum (fontName: Str255; VAR theNum: INTEGER); 


GetFNum returns in theNum the font number for the font having the given 
fontName. If there's no such font, GetFNum returns 0. 


FUNCTION RealFont (fontNum: INTEGER; size: INTEGER) : BOOLEAN; 


RealFont returns TRUE if the font having the font number fontNum is available in 
the given size in a resource file, or FALSE if the font has to be scaled to that 
size. 


Note: RealFont will always return FALSE if you pass applFont in fontNum. 
To find out if the application font is available in a particular 
size, call GetFontName and then GetFNum to get the actual font 
number for the application font, and then call RealFont with that number. 


Keeping Fonts in Memory 


PROCEDURE SetFontLock (lockFlag: BOOLEAN); 
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SetFontLock applies to the font in which text was most recently drawn. If 
lockFlag is TRUE, SetFontLock makes the font unpurgeable (reading it into memory 
if it isn't already there). If lockFlag is FALSE, it releases the 

memory occupied by the font (by calling the Resource Manager procedure 
ReleaseResource). Since fonts are normally purgeable, this procedure is useful 
for making a font temporarily unpurgeable. 


Advanced Routine 


The following low-level routine is called by QuickDraw and won't normally be 
used by an application directly, but it may be of interest to advanced 
programmers who want to bypass the QuickDraw routines that deal with text. 


FUNCTION FMSwapFont (inRec: FMInput) : FMOutPtr; 


FMSwapFont returns a pointer to a font output record containing the size, style, 
and other information about an adapted version of the font requested in the 
given font input record. (Font input and output records are explained in the 
following section.) FMSwapFont is called by QuickDraw every time a QuickDraw 
routine that does anything with text is used. If you want to call FMSwapFont 
yourself, you must build a font input record and then use the pointer returned 
by FMSwapFont to access the resulting font output record. 


Fractional Widths and Scaling 


Note: The extensions to the Font Manager described in the following paragraphs 
were originally documented in Inside Macintosh, Volume IV. As such, 
this information refers to the 128K ROMs and System file version 3.2 
and later. 


To improve the speed and readability of text display in your application, use 
the SetFractEnable and SetFScaleDisable procedures to enable fractional 
character widths and disable font scaling. Certain applications do not work 
properly when fractional character widths are used and font scaling is disabled, 
so these features are turned off by default. 


The FontMetrics function is much like QuickDraw's GetFontInfo function except 
that it returns fixed-point values, letting you draw characters in more precise 
locations on the screen. 

If there's a 'FOND' resource associated with the most recently drawn font, 
making the font resource purgeable or unpurgeable with the SetFontLock procedure 
will make the 'FOND' resource resource purgeable or unpurgeable as well. 
PROCEDURE FontMetrics (VAR theMetrics: FMetricRec); 


FontMetrics is similar to the QuickDraw procedure GetFontInfo except that it 
returns fixed-point values for greater accuracy in high-resolution printing. 


The FMetricRec data structure is defined as follows: 


TYPE FMetricRec = RECORD 
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ascent: Fixed; {ascent} 


descent: Fixed; {descent} 

leading: Fixed; {leading} 

widMax: Fixed; {maximum character width} 

wTabHandle: Handle; {handle to global width table} 
END; 


Ascent, descent, leading, and widMax are identical in function to their 
counterparts in GetFontInfo. WlabHandle is a handle to the global width table 
(described below). 


PROCEDURE SetFractEnable (fractEnable: BOOLEAN) [Not in 64K ROM] 


SetFractEnable lets you enable or disable fractional character widths. If 
fractEnable is TRUE, fractional character widths are enabled; if it's FALSE, the 
Font Manager uses integer widths. To ensure compatibility with existing 
applications, fractional character widths are disabled by default. 


SetFractEnable, which was not in the 128K ROM (but was available in the Pascal 
interfaces) has been added to both the Macintosh SE and Macintosh II ROMs. 


Assembly- language note: Assembly-language programmers should call 
SetFractEnable rather than change the value 
of the global variable FractEnable. 


PROCEDURE SetFScaleDisable (fontScaleDisable: BOOLEAN); 


SetFScaleDisable lets you disable or enable font scaling. If fontScaleDisable is 
TRUE, font scaling is disabled and the Font Manager returns an unscaled font 
with more space around the characters; if it's FALSE, the Font Manager scales 
fonts. To ensure compatibility with existing applications, the Font Manager 
defaults to scaling fonts. 


Assembly-language note: All programmers should use the SetFScaleDisable 
procedure to disable and enable font scaling. In 
particular, setting the global variable FScaleDisable 
is insufficient. 
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SUMMARY OF THE FONT MANAGER 


Constants 
CONST 
{ Font numbers } 
systemFont = 0; {system font} 
applFont = 1; {application font} 
newYork = 2; 
geneva = 3; 
monaco = 4; 
venice = 5; 
London = 6; 
athens laa 2 
sanFran = 8; 
toronto = 9; 
cairo = 11; 
losAngeles = 12; 
times = 20; 
helvetica = 21; 
courier = 22; 
symbol = 23; 
taliesin = 24; 


{ Special characters } 


commandMark = $11; {Command key symbol} 
checkMark = $12; {check mark} 
diamondMark = $13; {diamond symbol} 
appleMark = $14; {apple symbol} 


{ Font types [Volume IV addition] } 


propFont = $9000; {proportional font} 
prpFntH = $9001; { with height table} 
prpFntw = $9002; { with width table} 
prpFntHw = $9003; { with height & width tables} 
fixedFont = $B000; {fixed-width font} 
fxdFntH = $B001; { with height table} 
fxdFntwW = $B002; { with width table} 
fxdFntHw = $B003; { with height & width tables} 
fontwid = $ACBO; {font width data: 64K ROM only} 
Data Types 
TYPE 
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FMInput = PACKED RECORD 


family: INTEGER; {font number} 
size: INTEGER; {font size} 
face: Style; {character style} 
needBits: BOOLEAN; {TRUE if drawing} 
device: INTEGER; {device-specific information} 
numer: Point; {numerators of scaling factors} 
denom: Point {denominators of scaling factors} 
END; 
FMOutPtr = *FMOutput; 
FMOutput = PACKED RECORD 
errNum: INTEGER; {not used} 
fontHandle: Handle; {handle to font record} 
bold: Byte; {bold factor} 
italic: Byte; {italic factor} 
ulOffset: Byte; {underline offset} 
ulShadow: Byte; {underline shadow} 
ulThick: Byte; {underline thickness} 
shadow: Byte; {shadow factor} 
extra: SignedByte; {width of style} 
ascent: Byte; {ascent} 
descent: Byte; {descent} 
widMax: Byte; {maximum character width} 
leading: SignedByte; {leading} 
unused: Byte; {not used} 
numer: Point; {numerators of scaling factors} 
denom: Point {denominators of scaling factors} 
END; 
FontRec = RECORD 
fontType: INTEGER; {font type} 
firstChar: INTEGER; {ASCII code of first character} 
LastChar: INTEGER; {ASCII code of last character} 
widMax: INTEGER; {maximum character width} 
kernMax: INTEGER; {negative of maximum character kern} 
nDescent: INTEGER; {negative of descent} 
fRectWidth: INTEGER; {width of font rectangle} 
fRectHeight: INTEGER; {height of font rectangle} 
owTLoc: INTEGER; {offset to offset/width table} 
ascent: INTEGER; {ascent} 
descent: INTEGER; {descent} 
leading: INTEGER; {leading} 
rowwords: INTEGER; {row width of bit image / 2} 
{ bitImage: ARRAY[1..rowWords,1..fRectHeight] OF INTEGER; } 
{bit image} 
{ locTable: ARRAY [firstChar..lastChar+2] OF INTEGER; } 
{location table} 
{ owlable: ARRAY [firstChar..lastChar+2] OF INTEGER; } 


{ widthTable: 


{offset/width table} 


ARRAY [firstChar..lastChar+2] OF INTEGER; } 


{width table [Volume IV addition] } 


ARRAY [firstChar..lastChar+2] OF INTEGER; } 


{ heightTable: 
{height table [Volume IV addition] } 
END; 
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{Volume IV addition} 


FMetricRec = RECORD 


ascent: Fixed; {ascent} 
descent: Fixed; {descent} 
leading: Fixed; {leading} 
widMax: Fixed; {maximum character width} 
wTabHandle: Handle; {handle to global width table} 
END; 
FamRec = RECORD 
ffFlags: INTEGER; {flags for family} 
ffFamID: INTEGER; {family ID number} 
ffFirstChar: INTEGER; {ASCII code of the first character} 
ffLastChar: INTEGER; {ASCII code of the last character} 
ffAscent: INTEGER; {maximum ascent for 1-pt. font} 
ffDescent: INTEGER; {maximum descent for 1-pt. font} 
ffLeading: INTEGER; {maximum leading for 1-pt. font} 
ffWidMax: INTEGER; {maximum width for 1-pt. font} 
ffWwTabOff: LONGINT; {offset to width table} 
ffKernOff: LONGINT; {offset to kerning table} 
FfFStylorff: LONGINT; {offset to style-mapping table} 
ffProperty: ARRAY[1..9] OF INTEGER; {style property info} 
ffIntl: ARRAY[1..2] OF INTEGER; {reserved} 
ffVersion: INTEGER; {version number} 
{ ffAssoc: FontAssoc;} {font association table} 
{ ffWidthTab: WidTable;} {width table} 
{ ffStyTab: StyleTable;}{style-mapping table} 
{ ffKernTab: KernTable;} {kerning table} 
END; 


WidthTable = RECORD 
tabData: ARRAY[1..256] OF Fixed; { character widths} 
tabFont: Handle; {font record used to build table} 
sExtra: LONGINT; {space extra used for table} 


style: LONGINT; {extra due to style} 

FID: INTEGER; {font family ID} 

fSize: INTEGER; {font size request} 

face: INTEGER; {style (face) request} 

device: INTEGER; {device requested} 

inNumer: Point; {numerators of scaling factors} 
inDenom: Point; {denominators of scaling factors} 
aFID: INTEGER; {actual font family ID for table} 
fHand: handle; {family record used to build table} 
usedFam: BOOLEAN; {used fixed-point family widths} 
aFace: Byte; factual face produced} 


vOutput: INTEGER; {vertical factor for expanding } 
{ characters} 

hOutput: INTEGER; {horizontal factor for expanding } 
{ characters} 

vFactor: INTEGER; {not used} 

hFactor: INTEGER; {horizontal factor for increasing } 
{ character widths} 


aSize: INTEGER; {actual size of actual font used} 
tabSize: INTEGER {total size of table} 
END; 
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Routines 

Initializing the Font Manager 

PROCEDURE InitFonts; 

Getting Font Information 

PROCEDURE GetFontName (fontNum: INTEGER; VAR theName: Str255); 
PROCEDURE GetFNum (fontName: Str255; VAR theNum: INTEGER); 
FUNCTION RealFont (fontNum: INTEGER; size: INTEGER) : BOOLEAN; 
Keeping Fonts in Memory 

PROCEDURE SetFontLock (lockFlag: BOOLEAN) ; 

Advanced Routine 

FUNCTION FMSwapFont (inRec: FMInput) : FMOutPtr; 

Fractional Widths and Scaling [Volume IV addition] 

PROCEDURE FontMetrics (VAR theMetrics: FMetricRec); 


PROCEDURE SetFScaleDisable (fontScaleDisable: BOOLEAN); 
PROCEDURE SetFractEnable (fractEnable: BOOLEAN); [Not in 64K ROM] 


Assembly-Language Information 
Constants 


» Font numbers 


sysFont .EQU 0 system font 
applFont .EQU 1 ;application font 
newYork . EQU 2 

geneva . EQU 3 

monaco . EQU 4 

venice . EQU 5 

London . EQU 6 

athens . EQU 7 

sanFran . EQU 8 

toronto . EQU 9 

cairo . EQU 11 

LosAngeles .EQU 12 

times . EQU 20 

helvetica . EQU 21 

courier . EQU 22 

symbol .EQU 23 

taliesin . EQU 24 


; Special characters 


@ SpInside Macintosh ¢ Version 1.0 * November 1989 « Apple Computer 
THE FONT MANAGER e 50 of 54 


commandMark 
checkMark 
diamondMark 
appleMark 


. EQU $11 ;Command key symbol 
. EQU $12 scheck mark 

.EQU $13 ;diamond symbol 
.EQU $14 ;apple symbol 


; Font types [Volume IV addition] 


propFont 
prpFntH 
prpFntw 
prpFntHw 


fixedFont 
fxdFntH 
fxdFntw 
fxdFntHw 
fontWid 

s Control and 


fMgrCtll 


. EQU $9000 
. EQU $9001 ; with height table 

. EQU $9002 ; with width table 

. EQU $9003 ; with height & width tables 


. EQU 8 


;proportional font 


. EQU $B000 ;fixed-width font 

. EQU $B001 ; with height table 

. EQU $B002 ; with width table 

. EQU $B003 ; with height & width tables 
. EQU $ACBO ;font width data 


Status call code 


;code used to get and modify font 
; characterization table 


Font Input Record Data Structure 


fmInFamily 
fmInSize 
fmiInFace 
fmInNeedBits 
fmInDevice 
fmInNumer 
fmInDenom 


Font number (word) 

Font size (word) 

Character style (word) 

Nonzero if drawing (byte) 

Device-specific information (byte) 

Numerators of scaling factors (point; long) 
Denominators of scaling factors (point; long) 


Font Output Record Data Structure 


fmOutFontH 
fmOutBold 
fmOutItalic 
fmOutULOffset 
fmOutULShadow 
fmOutUlLThick 
fmOutShadow 
fmOutExtra 
fmOutAscent 
fmOutDescent 
fmOutWidMax 
fmOutLeading 
fmOutNumer 
fmOutDenom 


Handle to font record 

Bold factor (byte) 

Italic factor (byte) 

Underline offset (byte) 

Underline shadow (byte) 

Underline thickness (byte) 

Shadow factor (byte) 

Width of style (byte) 

Ascent (byte) 

Descent (byte) 

Maximum character width (byte) 

Leading (byte) 

Numerators of scaling factors (point; long) 
Denominators of scaling factors (point; long) 


Font Metric Record Data Structure [Volume IV addition] 


ascent 
descent 


Ascent (word) 
Descent (word) 
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leading Leading (word) 
widMax Maximum character width (word) 
wTabHandle Handle to global width table (long) 


Font Record ('FONT' or 'NFNT') Data Structure [Volume IV addition] 


fFontType Font type (word) 

fFirstChar ASCII code of first character (word) 
flastChar ASCII code of last character (word) 
fwidMax Maximum character width (word) 

fKernMax Negative of maximum character kern (word) 
fNDescent Negative of descent (word) 


fFRectWidth Width of font rectangle (word) 
fFRectHeight Height of font rectangle (word) 


fOWTLoc Offset to offset/width table (word) 
fAscent Ascent (word) 

fDescent Descent (word) 

fleading Leading (word) 

fRowwords Row width of bit image / 2 (word) 


Family Record ('FOND') Data Structure [Volume IV addition] 


fondFlags Flags for family (word) 

fondFamID Family ID number (word) 

fondFirst ASCII code of first character (word) 

fondLast ASCII code of last character (word) 

fondAscent Maximum ascent expressed for 1 pt. font (word) 
fondDescent Maximum descent expressed for 1 pt. font (word) 
fondLeading Maximum leading expressed for 1 pt. font (word) 
fondWwidMax Maximum widMax expressed for 1 pt. font (word) 


fondwTabOf f Offset to width table (long) 
fondKernOf f Offset to kerning table (long) 
fondStyloff Offset to style-mapping table (long) 
fondProperty Style property info (12 words) 


fondIntl Reserved (3 words) 
fondAssoc Font association Table (variable length) 
fondWidTab Optional character-width table (variable length) 


fondStylTab Style-mapping table (variable Length) 
fondKerntab Kerning table (variable length) 


Global Width Table Data Structure [Volume IV addition] 


widTabData Character widths (1024 bytes) 
widTabFont Font handle used to build table (long) 
widthSExtra Space extra used for table (long) 
widthStyle Extra due to style (long) 

widthFID Font family ID (word) 

widthFSize Font size request (word) 

widthFace Style (face) request (word) 
widthDevice Device requested (word) 

inNumer Numerators of scaling factors (long) 
inDenom Denominators of scaling factors (long) 
widthAFID Actual font family ID for table (word) 
widthFHand Font family handle for table (long) 
widthUsedFam Used fixed point family widths? (boolean) 
widthAFace Actual face produced (byte) 
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widthVOutput Not used (word) 

widthHOutput Horizontal factor for increasing character widths (word) 
widthVFactor Vertical scale output value (word) 

widthHFactor Horizontal scale output value (word) 

widthASize Actual size of actual font used (word) 

widTabSize Total size of table (word) 


Special Macro Names 


Pascal name Macro name 

GetFontName _GetFName 

Variables 

ApFontID Font number of application font (word) 
FScaleDisable Nonzero to disable scaling (byte) 
ROMFont0 Handle to font record for system font 


Volume IV addition 


FractEnable Nonzero to enable fractional widths (byte) 

IntlSpec International software installed if greater than 0 (long) 
WidthListHand Handle to a list of handles to recently-used width tables 
WidthPtr Pointer to global width table 

WidthTabHandle Handle to global width table 

SysFontFam If nonzero, the font number to use for system font (byte) 
SysFontSiz If nonzero, the size of the system font (byte) 

LastFOND Handle to last family record used 


Volume V addition 


SynListHandle Handle to synthetic font list 
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Further Reference: 


Resource Manager 

QuickDraw 

Device Manager 

Technical Note #26, Character vs. String Operations in QuickDraw 
Technical Note #30, Font Height Tables 

Technical Note #191, Font Names 

Technical Note #198, Font/DA Mover, Styled Fonts, and 'NFNT's 
Technical Note #245, Font Family Numbers 


END OF DOCUMENT 
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